package com.employment.service;

import com.mybatisflex.core.paginate.Page;
import com.employment.entity.Resume;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 简历管理服务接口
 * 
 * @author Employment System
 * @since 1.0.0
 */
public interface ResumeService {

    /**
     * 创建简历
     *
     * @param resume 简历信息
     * @return 创建结果
     */
    boolean createResume(Resume resume);

    /**
     * 更新简历信息
     *
     * @param resume 简历信息
     * @return 更新结果
     */
    boolean updateResume(Resume resume);

    /**
     * 删除简历
     *
     * @param resumeId 简历ID
     * @return 删除结果
     */
    boolean deleteResume(Long resumeId);

    @Transactional(rollbackFor = Exception.class)
    boolean deleteResume(Long resumeId, Long userId);

    /**
     * 根据ID查询简历详情
     *
     * @param resumeId 简历ID
     * @return 简历详情
     */
    Resume getResumeById(Long resumeId);

    /**
     * 根据用户ID查询简历列表
     *
     * @param userId 用户ID
     * @return 简历列表
     */
    List<Resume> getResumesByUserId(Long userId);

    /**
     * 查询用户默认简历
     *
     * @param userId 用户ID
     * @return 默认简历
     */
    Resume getDefaultResumeByUserId(Long userId);

    /**
     * 分页查询公开简历
     *
     * @param page      分页参数
     * @param keyword   关键词
     * @param city      城市
     * @param position  期望职位
     * @param industry  期望行业
     * @param jobStatus 求职状态
     * @return 简历分页列表
     */
    Page<Resume> getPublicResumePage(Page<Resume> page,
                                   String keyword,
                                   String city,
                                   String position,
                                   String industry,
                                   Integer jobStatus);

    /**
     * 设置默认简历
     *
     * @param userId   用户ID
     * @param resumeId 简历ID
     * @return 设置结果
     */
    boolean setDefaultResume(Long userId, Long resumeId);

    /**
     * 增加简历浏览次数
     *
     * @param resumeId 简历ID
     * @return 更新结果
     */
    boolean increaseViewCount(Long resumeId);

    Integer calculateCompleteness(Resume resume);

    @Transactional(rollbackFor = Exception.class)
    boolean updateCompleteness(Long resumeId);

    /**
     * 复制简历
     *
     * @param resumeId 原简历ID
     * @param userId   用户ID
     * @return 新简历
     */
    Resume copyResume(Long resumeId, Long userId);

    /**
     * 导出简历
     *
     * @param resumeId 简历ID
     * @return 导出文件路径
     */
    String exportResume(Long resumeId, String format);

    @Transactional(rollbackFor = Exception.class)
    boolean increaseDownloadCount(Long resumeId);

    /**
     * 搜索简历
     *
     * @param keyword 关键词
     * @param limit   限制数量
     * @return 简历列表
     */
    List<Resume> searchResumes(String keyword, Integer limit);
}